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APF BASIC 

This version of the popular BASIC computer language has been specifically designed 
and written for the APF Imagination Machine. Special features of this language 
include 

• Three octave music system 

• High and low resolution color graphics. 

• Hand control input commands. 

• Four place, fixed decimal arithmetic with 12 digit accuracy. 

The information in this manual is organized and presented for use by experienced 
programmers For an introduction to BASIC programming, we suggest BASIC Tutor'” 
-an interactive leaching system available lor your APF personal computer. 
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CHAPTER 1 KEYBOARD AND HAND CONTROLS §■■■ 

Study Ide keyboard carelully. Most of the keyboard is like a standard typewriter with 
several special keys In addition to the special keys the Imagination Machine also has 
two rows of control keywords across the top ot the keyboard. Use of the special keys 


described 

1 

n the section below. 

) 
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ESC 

When ESC is pressed a | appears on the screen 

CTRL 

The CTRL key allows you lo use the control keywords printed above the top row of 
keys. The two rows of control keywords correspond to the top two rows of keys 
To print GOTO on the screen hold down the CTRL key and press the 0 key. To print 
CLOADon the screen hold down the CTRL key and press the RETURN key 

SHIFT 

Since the computer has no lower case letters the SHIFT keys are only used to print 
the symbols on the upper half ot the number keys and wherever shown on other keys. 

HERE IS 

Is not used m the current version of APF BASIC 

LINE FEED 

Is not used in the current version of APF BASIC. 

RETURN 

The RETURN key acts like the carriage return on a typewriter. It is also used to tell 
the computer when you are through entering When this key is pressed the computer 
will look at what you have typed and decide what lo do with it 

RUB OUT 

The RUBOUT key is used lo back space and erase one character at a time 

HEFT 

The REPT I repeat) key is used to make any other key print continuously on the screen 
iis long as you hold down both keys up to the maximum line length ot 128 characters. 

BRK 

The BRK (break) key causes your program to stop running and return to user input 
or control mode It does not function during an input statement or while saving and 
loading on tape. 

HAND CONTROLS 

There are Iwo hand controllers attached to the MP lOOO One is marked with an L 
tor left and the other with an R lor right. They can be accessed with a key $ function 
(P 12 I 
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CHAPTER 2 GENERAL 


VARIABLES 

There are two types of variables, number variables or letter variables The maximum 
number of variables is 26. 

NUMBER VARIABLES — Number variables can be up to 13 digits long ranging from 
♦999.999.999 9999 to -999,999,999 9999 

LETTER VARIABLES-Letler variables can contain up to 100 characters The maxi- 
mum length of each letter variable must be defined with a dimension statement 

VARIABLE NAMES-Vanable names can be up to 5 characters long, but only the 
first 2 characters are used. Names cannot ctintain a keyword The first character must 
be a letter Letter variable names must end with a $. 

EXAMPLE Variable names that are correct but different 
A,A$. A1. A1$, A2SAM. A2SAM$ 

Variable names that the computer sees as being the same. 

AL. ALSAM. ALLEN. ALL. AL123 
Variable names that are illegal and don t work 
3AL. A$B. A3# 

ALGEBRAIC OPERATORS 

The symbols used for arithmetic operations are 

♦ a-rb arithmetic addition a plus b 

- a-b arithmetic subtraction a minus b 

• a'b multiplication a times b 

/ a/b division a divided by b 

f afb exponetiaiion a to the b power— note 

b must be an integer 

RELATIONAL AND LOGICAL OPERATORS 

Used to compare 2 values, produces a true or false result. 

a = b a equal b 

a<>b a not equal b 

a < b a less than b 

a > b a greater than b 

a< - b a less than or equal b 

a>=b a greater than or equal b 

RULES OF PRECEDENCE 

Expressions are evaluated with operators having the following precedence 
highest precedence negation 

1 exponention 
•./ multiplication/division 
-,+ addition/subtraction 
lowest precedence relational 

When 2 operators of the same precedence occur, the expression is evaluated left 
to right 

LINE LENGTH 

Maximum line length is 128 characters Keywords count as one character 

SPACING 

All spaces are ignored except those mside quotation marks or in REM statements, 
or in a print using definition. 

MULTIPLE STATEMENTS/LiNE 

Multiple statements are separated by a colon 

ex. 10 PRINT 123. IF A^B THEN GOTO 30 

MAX LINE# 

Maximum line » is 9999 All line # s must be integer only 



I CHAPTER 3 COMMANDS 



EDIT 

The EDIT statement is used to change a portion of a line in your program. It must be 
followed by the line number you want to change and the ESC key Then type the 
section of the statement you want to change Press the ESC key again and then the 
new characters 

EXAMPLE EDIT N ESC X ESC V RETURN 


N IS line « to be edited 
X IS text to be deleted 


Y IS text to replace X 
EXAMPLE too INPUT A$ PRINT INS 

?00 IF INS = NOT THEN 1000 
300 IF INS= YES THEN 100 
EDIT 100IASIINS 
EDIT 2001 TI 

EDIT 300M00I RETURN 
LIST 

too INPUT INS. PRINTINS 
200IFIN$^ NO THEN 1000 
300IFIN$^ YES THEN RETURN 

LIST 

Lists all lines m your program 


LIST too 

Lists line too of program 


LIST 100, 

Lists from line 100 to end of program 


LIST 100,5 

Lists live lines of your program, beginning with line number 100 


RUN 

Sets all variables to zero Execution then begins with the first line in your program. 




CHAPTER 4 PROGRAM STATEMENTS! 


CALL 


Transfers program execution to a machine language routine written in M 6800 object 
code 

EXAMPLE CALL 17046 


This call branches your program to a special sub-routme that begins at 
location 17046 This particular sub-routine will clear the TV screen When 
a 6800 RTS instruction occurs return will be to the next basic statement 


DATA 5. 10. BILL 

Stores data to be accessed by READ statements Data items will be read sequentially 
Hems may be numbers or characters but not expressions Each data item must be 
separated bv a comma 

DIM 

Reserves memory tor strings lists of strings or tables of numbers 
EXAMPLE DIM ASdOl 8S(4 12I,C|5.8) 


This example reserves memory for an 11 character string. |A$|,5 strings 
of 13 characters each. (BSi.and a table of numbers fhal is 6 rows by 9 
columns iCi Maximum string length is 100 characters. A$(99) 
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END 

Stops program and returns control to the console. 

FORA=BTOC 

Combines with a NEXT statement to form a loop. Variable A begins with the value of 
B and increments to the value of C. 

FORA=10TO1 STEP-1 

Combines with a NEXT statement to count from 10 to 1 . Note: it step value is not 
given, it is assumed to be 1 
EXAMPLE 10 FOR A = 10 to 1 STEP -1 
20 PRINT A 
30 NEXT A 

GOSUB 100 

Calls a BASIC subroutine located at line 100 

GOTO 100 

Transfers program to line 100. 

IFA = BTHEN 300 

Transfers program to line 300 if A equals B. If A is not equal to B the rest of the line 
is not read by the computer and the program transfers to the next numbered line. 
Any comparison can be used, such as; 

<> not equal 
> greater than 
< less than 

>= greater than or equal 
< = less than or equal 

IF A$<=BS THEN GOSUB 2000 

Transfers program to the subroutine at 2000 if A$ is less than B$. The value of A$ is 
compared to the value of BS alphabetically Numerals come before letters alpha- 
betically 

IF A B THEN PRINT “EQUAL ":ENO 

Prints the word EQUAL and ends the program if A and B are not equal. If A equals B 
then the next line of the program is executed. 

INPUT A 

Reads data from the keyboard A question mark is displayed to indicate that the com- 
puter is wailing for a response Separate multiple input items with a comma Command 
IS only terminated after a return key is pressed. 

EXAMPLE: INPUT A.B 

The user must respond with two numbers separate by commas. If only one input is 
given, then computer automatically asks for second one (B) 

INPUT A$.B 

The user must enter a character string comma and a number 

INPUT "AMOUNr. A 

Prints the word AMOUNT followed by a question mark and waits for the user to type 
in a number 

NOTE: tf a number is being requested and the user responds with a group of characters 
beginning with a letter, then the computer accepts the input as if he types a 0 
If the user types a group of characters beginning with one or more numerals the 
computer accepts those numerals as the number. 
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LETA-^5or A = 5 

Sets the variable A equal to the constant 5 The word LET is optional and A=5 also 
works The constant 5 can be replaced by an anfhmatic expression 
EXAMPLE A -3'lB-Cl ' 4 

B 3 + B/C •AA2'C 

This example is equivalent to B=3 + (B/C) -|(A/.2)'C) 


ON A GOSBB 1000.1200.1500.2000 

Calls one ot a list ol subroutines, depending on the value ol A If A equals one. GOSUB 
1000 results, it A equals two, GOSUB 1200 results, and it A equals three. GOSUB 
1500 results If A equals any other value then GOSUB 2000 results 


ON A GOTO 10.20.30 

Jumps to one of a list ol lines, depending on the value of A It A equals one. GOTO 
10 results and if A equals two, GOTO 20 results Any other value results m a GOTO 30 


POKE 784.1 

Places the number 1 in memory location 784 This POKE displays the letter A in the 
middle of your screen. Any memory location can be poked as long as it is between 
0 and 65, 536, The value poked must be a positive integer from 0 to 255 If greater 
than 255. modulo (2551 is performed 


PRINT A 

Prints the value of A 

PRINT A.B 

Prints the values of A and B in separate columns Columns are automatically 8 char- 
acters wide lie A is column i . B is printed in column 9) 

PRINT A,B 

Prints the values ol A and B with no spaces between them 


PRINT A:TAB(I0):B 

Prints the value of A spaces ten characters from the left margin and prints the value 
of B 

PRINTA.SPC(10);B 

Prints the value ol A. spaces ten characters from the last character in A, and prints 
the value of B 


PRINT HELLO' 

Prints HELLO. 

PRINT USING ' SSAAtr.AA' .A 

Prints the value of A with a leading dollar sign and two decimal places $29 50. 
$104,01 $ 02. etc. You must use as many pound signs i«i as there are digits m the 
value of A 


PRINT USING -nnnnnnntt TOTAL IS ###" A5,B 

Replaces the pound signs (ot with the characters in AS and the value of B SATUR- 
DAY TOTAL IS 128 DOOMSDAY TOTAL IS 27 TOTAL IS 365, etc 

PRINT USING AS.B 

Prints the value of B using the characters in AS as the format The formal string is 
contained m the string variable Al 

to 


PRINT USING 100.A 

Prints the value of A, using the data in line 100 as the format. Line 100 must begin 
with a colon and quotes are not required. 

100 :##.### 

100 .$$##»#.## 

100 :LAST QUOTE:#### 


Reads data into specified variable from DATA statement 
EXAMPLE; 100 DATA37.BILL.SAM,8 
200 READ A,B$ 

300 READ C$,D,E,F$ 

310 DATA42,THE 

Note that DATA statements can be placed after the READ statements 


RESTORE 

Resets the data pointer so that the next READ statement begins with the first DATA 
statement in the program. 

EXAMPLE- 100 DATA 37, BILL, 8.SAM 
200 READ A.B$ 

300 RESTORE 
400 READC,D$ 

In this example C will be assigned the value 37. 

RETURN 

Returns from the subroutine to the statement following the GOSUB. 

STOP 

Stops the program 


CHAPTER 5 ARITHMETIC FUNCTIONS 

All functions are written of the form 
NAME(X) 

Name is the function mnemonic. No spaces are allowed between the name and the 
left parenthesis. 

X IS the operand and can be a constant, expression or function 

ABSfXI— returns absolute value of x 
ABS(- 1.2) = 1 2 
ABS(O) = 0 
ABSd 45) = 1.45 

INT(X)— returns integer portion of X Fractional portion of x is truncated. 

INTI12.34I = 12 

PEEKfX}— returns decimal value stored in memory location x. X is a decimal address. 
EXAMPLE. A^ PEEK (41452) 

In this example the value of memory location 41452 is placed in A If it is ©then 
CSAVE will place the TV image at the beginning of your tape 

RNO(X) random number between 0 and Q.9999 


SGN(X) 1 if x>0, - 1 if x<O.0 if x=0. 



CHAPTER 6 STRING FUNCTIONS 



ASClAS) Returns ASCII Code o1 the tirst character in AJ. 


ex PRINT ASC( A 1 
65 


This IS decimal ASCII code tor letter A 


CHRS(N) Produces string of one character length whose ASCII code is N 
Ex PRINT CHR$l3tl 

— This IS the literal whose ASCII code is decimal 3i. 


LEN(AS) Returns t» ot characters (Length) m A$ 
EX DIM A$(10) 

A$ ^ ABC 
PRINT LEN IAS) 


Length is 3 
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KEY$(0) Reads the typewriter keyboard H no key is pressed. A$ = ' If key is pressed, 
AS - C where C is the character typed. 

EXAMPLE to A$--^KEY$(0| IFA$- THEN10 


20 PRINT AS 


Line 10 is asking if any key on the keyboard is pressed. It no. it loops back to the 
beginning of line 10 and asks again If a key is pressed, the program drops through 
to line 20 and prints that key on the screen 


AS°KEY$<2) 

Reads the left hand control it no key is pressed. A$= . It key 0 to 9 is pressed, 
AS n where n is the number ot the key If the knob is moved. A$= d where d is 
the direction (N S.E. or Wl If CL is pressed. A$- If either EN or the FIRE button 
is pressed. A$= ' 


AS°KEY$(1) 

Reads the right hand control in the same manner as described above 


ADDRESSING CHARACTERS IN A STRING 

Since strings are dimensional as arrays, it is possible to address any character or 

group of characters m a string 

EXAMPLE: 

DIM AS(9) BSlD 
A$ ABCDEFGHIJ 

PRINT A$ This prints ABCDEFGHIJ 

PRINT A$(4| This prints EFGHIJ 

BS AS(3) PRINT BS This prints DE 


iCHAPTERTMUSICi 


Using Ihe MUSIC command, you can write and play music on your computer using 
numbers. The numbers 1 through 7 play the musical scale. 


2 4 6 

13 5 7 



To play one octave higher, place a multiply sign (*) in front of the number, and to 
play one octave lower, place a divide ( / ) sign in Iront of the number. 

/I /3 /5 /7 2 46 *1 *3 *5 *7 



You can also play sharps and flats by typing a + or - sign in front of the note. 

The number zero lOl is used to hold the previous note. 

Leaving a space between numbers creates a pause in the music. 

EXAMPLE; MUSIC' 3212333' 

MUSIC-3212333000" 

If the music plays loo Quickly you can slow it down by placing a 0 between each note. 

MUSIC 302010203030- 
Spaces create a different sound. 

MUSIC S 2 1 2 3 3 3 

If you want to use the same sequence of notes over and over you can assign them 
to a variable. 

MUSICA$,B$ 

EXAMPLE: 10 For 1=1 to 10 

20 Music -/1/2/3/4/5/6/71234567*1*2*3*4*5-6'7 
30 Next I 

EXAMPLE: Let s try a song. 

MUSIC 32123 33222355 32123 33322 321" 

EXAMPLE: Using AS.BS 

A$="5552332- 
B*= -77665' 

MUSIC AS, 6$ 
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CHAPTER 8 GRAPHICS (64x32) 

The low resolution graphics mode divides the screen into 512 cursor size rectangles. 
32 columns wide by 16 rows high (32 x 161 These are the same 512 boxes used to 
show alphanumerics and therefore this mode allows mixing of alphaoumerics and 
color graphics on the screen. 


COLOR 

Any cursor position can be any one of eight colors at any time by assigning it a color 
number from 0 to 7 Setting COLOR= expression determines the color to be used in the 
next line or plot command Expression can be a constant or expression Modulo 
arithmetic is performed so the expression can.be greater than>7, 

0 Dark Green 4 = White 

1 - Yellow 5 = Light Green 

2 - Blue 6 = Purple 

3 - Red 7 = Orange 

This means you can have eight different colors on the screen at the same time. 

SHAPE 

To get higher resolution each cursor position -can be divided into four cells By se- 
lecting the appropriate shapes you can draw a picture with much higher resolution 
(64 X 321. 


The shape table shows the number for each cursor shape. 

"I 'B ‘I "B 




■H 'H "ffl "E 

Shape IS set equal to a constant or expression It s value is used m the next plot or 
line command modulo 15 arithmatic is performed so shape can be greater than 15. 


Since only one color can be assigned to a cursor position the cells that are lit will all 
be the same color and the remaining cells will be black 


SHAPE 6 
COLOR 1 


BLACK 

YELLOW 


I 


YELLOW 

BLACK 


To select the X and Y position on the screen where you want the shape to appear 
use the PLOT command. 


PLOT 10.8 

Means place the shape in the tOth column in the 8th 


1 



To place shape 6 on the screen in yellow and black in the position X = 10, Y = 8 the 
command would be: 

COLOR = TSHAPE=6:PLOT10,8 

LINE 

To draw a horizontal line of the selected shape use the HLIN command and specify 
the starting column, the ending column and the row. 

HUN 10.20.8 

Means draw a line starting in column 10 ending m column 20 using row 8. The same 
process is used to draw vertical lines on the screen. 

VLIN 8.12.10 

Means draw a vertical line starting in row 8 ending in row 12 using column 10. 

NOTE: If you plot a shape on top of another shape the second shape is added to the 
first shape;it does not replace it. The new shape takes on the new color. 
Plotting a 9 on top of a 6 gives you a 1 5 
EXAMPLE 10SHAPE = 15 
20 FOR 1=0 to 7 
30 COLOR=I 
40 HLIN 1,31-1. 1 
50 HLIN 1,31-1. 15-1 
60 VLIN 1,15-1. 1 
70 VLIN I, 15-1,31-1 
80 NEXT 1 
90 GOTO 90 
CLEAR SCREEN 

To clear the screen use CALL 17046 
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EXAMINE SCREEN LOCATION 

A^PEEK|5I2 + Y'32 + X) 

EXAMPLE. 

PRINT PEEK(512 + 10*32+ 18) 

This prints the contents of the I8th position of the 10th row The numbers 512 ancJ 32 
are always used as shown. The other two numbers determine the X and Y coordinate 
of the screen. 


If A>1 27. the location contains a shape ( 


m 


. etc I 


If A< =127, the location contains a character (A. B. C. etc.) 


0<A<63 light green character on dark green 
A CHARACTER 

A (DIU PDDDDD 

CHARACTER CODE (APPENDIX A) 

64<A<1 27 dark green character on light green 
A "CHARACTER + 64 

A.pHnnnDpp 


CHARACTER CODE (APPENDIX A) 

t2a<A<255 shape 

A= 128 + COLOR* 16 + SHAPE 

A -□ □□□□□□□ 

COLOR SHAPE 


REVERSE VIDEO (BLACK/ORANGE) 

POKE 8193.60 

Changes color of reverse video characters from dark green on light green to black 
on orange. This does not affect letters in standard video, light green on dark green. 


REVERSE VIDEO (GREEN/GREEN) 

POKE 8193.52 

Restores Standard video. Use after POKE 8193.60 


LOCATE CURSOR 

A Peek(40960f256 * PEEK(40961I 
Places in A the position of the cursor 
A ROW32 I COLUMN * 512 



ROW COLUMN 


POSITION CURSOR 

Position cursor by setting A as shown and poking two locations. To position cursor 
at 22,7 

• L=7 

• P=22 

• A=L'32 + P + 512 

• POKE 40960. A/256 

• POKE 40961 .A-INT(A/256)*256 
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I CHAPTER 9 GRAPHICS C128x192} | 

Graphics mode (128 x 192)— There is a high resoluhorr graphics mode which has the 
following features. 

1 128 X 192 resolution 

2. 2 color sets each with 4 colors so there can be a total of 8 colors on the screen 
at once. 

MODE SELECT 

Enter this graphics mode with: 

POKE 8193.60 
POKE 8194,158 

Return to the (64 x 32) graphic mode with: 

POKE 8193,52 
POKE 8194.30 

When the computer is in this mode there is no alphanumerics capability. Therefore, 
pressing keys or the keyboard will not produce letters on the screen but will cause 
the computer to take a directed action. 

MEMORY MAPS 

Two memory areas are used. The screen map occupies memory locations 0 to 383 
and the shape table occupies locations 512 to 1023. 


SCREEN MAP 


31 


384 OBJECT BOXES 


The TV screen is divided into 384 object boxes ( 1 2 rows by 32 columns). Each box 

may contain any one of 32 special shapes 

These shapes are stored in the shape table and numbered 0 to 31 . 


SHAPE TABLE 
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DEFINE SHAPES 

In this graphic's mode each shape to be plotted on the screen is 4 dots wide and 16 
dots high. 

Each horizontal row of four dots is set with a POKE instruction. For example, this 
POKE sets the lop row of dots in shape number one to the colors Cl . C2, C3, and C4: 
POKE 51 2,C1 -64 + C2*16+C3‘4 4 C4 

Each color number is between 0 and 3. dependirrg on the color selected. The color 
tables are in the next section. 

The example at the end of this section shows how up to 32 shapes can be created 
with similar POKE instructions 

PLOT SHAPES 

After the shapes have been created in the shape table, they can be plotted on the 
screen. 

The format for each byte m the screen map is: 


[iinioiDnDnn 



COLOR TABLf 

If color table select 0 

0 GREEN 

1 YELLOW 

2 BLUE 

3 RED 

It color table select t 

0 WHITE 

1 AQUA 

2 PURPLE 

3 ORANGE 

NOTE: The color table is selected in the screen map and the specific color in the 
table is included in the shape definition. 

EXAMPLE; 

!OOL = 6:REM LINES ARE 0 TO 11 

1 10 P= 19;REM POSITIONS ARE 0 TO 31 

120S = 13;REM SHAPES ARE 0 TO 31 

130 T = 0:REM COLOR TABLES ARE 0 OR 1 

140 DATA 0 0 1 1REM A SHAPE IS 4 DOTS ACROSS 

150 DATA 0.0. l ..l;REM BY 16 DOTS DOWN 

160 DATA0.1.1.2;REM 

170 DATA0.1.1.2-.REM EACH DOT IS ONE OF FOUR 
180 DATA 1.1.2.2-.REM COLORS 
190 DATA 1 1.2.2:REM 

200 DATA 1.2.2.3;REM EACH COLOR IS NUMBERED 0 TO 3 

210 DATA 1.2. 2.3 

220 DATA 2.2.3 3 

230 DATA 2. 2.3.3 

240 DATA 2.3.3 0 

250 DATA 2.3 3.0 

260 DATA 3 3 0 0 

270 DATA 3.3.0 0 

280 DATA 3 0 0.1 

290 DATA 3 0.0 1 

300 REM 

310 REM SET UPTHE SHAPE 
320 REM 

330 FOR lOTO 15 
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340 READ A.B.C,D 

350 POKE 51 2 +S*16+1.A*64 + B'16+C'4 + D 
360 NEXTl 
370 REM 

380 REM PLACE THE SHAPE ON THE SCREEN USING 
390 REM THE CHOSEN COLOR TABLE 
400 REM 

410 POKE L’32+P,S+T'64 


CHAPTER 10 TAPE 

Tape Operation 

The tape system is specially designed lor the Imagination Machine. The key features 
are; 

1. Dual track tapes are used. One lor standard audio recording or playback, and the 
other for digital recording or playback, 

2. Microphone jack built in for audio recording. Any standard cassette microphone 
may be used. 

3. Separate speaker built in tor audio playback. Volume control is included. 

4. Semi-automatic computer control. Record or playback of either audio or digital is 
under computer control. Fast forward and rewind are manually operated. 

5. High speed digital transfer rate-approximately 1500 bits per second. 

6. Tape counter included to allow manual location (thru fast forward or rewind) of a 
desired section of tape. 

SAVING PROGRAMS 

CSAVE IS used to save program memory It is not necessary to press the record 
button on the tape deck since that is used only to record audio Do not delay more 
than 6 seconds when pressing the play /save button and the return key For an 8K 
system CSAVE lakes abou 45 seconds 

During a CSAVE all keyboard functions are inoperative CSAVE will save the entire 
amount of random access memory. 

Saving 512 Block for Screen 

In addition to the program memory, CSAVE first saves a block of 512 bytes. This will 
be placed on the screen first when loadirtg so pictures or messages can be stored. 
There are 2 possible blocks that can be saved. The selected one is determined by 
the contents of memory location 41452. 

If (41452) = 0 then locations 512-1023 (screen memory) are saved 
If 141452)= 255 then locations 0-511 (scratch memory) are saved. 

Saving Program Data 

Since CSAVE always saves all memory.then all dimensioned variables are also saved on 
tape. This can be used to save and revise data. Simply use a goto statement to start the 
program after loading (run automatically clears all variables). 

Note: After a reset is pressed, one RUN command is always necessary to initialize 
certain system constants. Therefore we recommend that if you want to use a tape 
with data, do the following sequence. 

1 CLOAD 

RUN 1st RUN alter reset 

Follow instructions to load 
When OK appears 

Type GOTO x where x is first statement of loaded program. 

LOADING TAPES 

CLOAD IS the command lor loading tapes The first 512 bytes of the tape are always 
put to screen memory. After that the next 8K bytes are read to program memory. At 
the end of loading there is a check sum to indicate all data is read correctly. If it was, 
the word OK appears on the left side of the screen and the cursor returns If anything 
except OK appears, it was a bad load and the tape must be reloaded 
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AUDtO RECORDING 

One of the nicer features of the Imagination Machine is that you can record your 
voice, or even music, on the same tape as your computer program To do this, plug a 
microphone into the microphone jack on the body of the keyboard unit and press the 
record key Now type in the following statement 
POKE 24578.62 


This turns on the motor Now talk or play music into the microphone. It is being re- 
corded on the audio track ot the tape without damaging or changing any programs 
you may have placed on the program track 
To turn oti the motor, type. 

POKE 24578.38 


AUDIO SHUTOFF 

To Stop the voice track on a program tape from playing through the speaker, type: 
POKE 24578.54 


MOTOR START/STOP 

To start the cassette tape motor and listen to the audio track, type 
POKE 24578.62 

To stop the cassette tape motor, type 
POKE 24578.38 


APPENDIX A 


RESERVED WORDS 

The following words c; 

ASS 

ASC 

CALL 

CHRS 

CLOAD 

COLOR 

CSAVE 

DATA 

DIM 

END 

FOR 

GOSUB 

GOTO 

HLIN 

IF 

INPUT 


not be used as or contained variable names 
MUSIC 
NEXT 
ON 
OPEN 
PEEK 
PLOT 
POKE 
PRINT 
READ 
RESTORE 
RETURN 
RND 
RUN 
SGN 
SHAPE 
SPC 
STEP 
STOP 
TAB 
THEN 
TO 

USING 

VLIN 


APPENDIX B 


ASCII CODES AND TOKENS 

The following are codes used lo place alphanomerics on the screen: 


APPENDIX C 

MACHINE LANGUAGE REFERENCE 

The Imagination Machine contains a machine language monitor. You can use 
the monitor to create, display, chartge, ar>d execute machine language programs. 
To use this appendix, you must be able to write programs in 6800 machine 
language. You must also have a working knowledge of hexadecimal notation. 

CALL 28672 

This BASIC statement takes you out of BASIC. You are now talking to the Ima- 
gination Machine Monitor, The Monitor pots a "* ” at the beginning of each line 
on the screen, When you sec the you can enter one of the three monitor 
comma nds: 

D nnnn where nnnn is a hexadecimal address 
G nnnn where nnnn is a hexadecimal address 
M nnnn where nnnn is a hexadecimal address 
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D nnnn - DISPLAY MEMORY 

This command will display the 16 bytes of memory beginning at address nnnn. 
To display the next 16 bytes, press the "I" key. To end the command, press the 
RETURN key. 

Example: ' D 9B3C 

' 9B3C20 EO B6 AO 58 BD 9A B6Ce 

AO 9C 7E 9A 28 7C AO/ 

• 9640 AA 20 D4 86 04 CE AO AA OC 
69 00 09 8C 80 9C 26 (Return) 

G nnnn - GOTO MEMORY ADDRESS 

This command acts much like the BASIC GOTO statemerjt except the value 
NNNN is a four digit hexadecimal memory address. The computer immediately 
begins executing the machine language program at that address. 

•G 8894 

Address 8894 is the start of the Imagination Machine’s BASIC. This is how you 
reenter BASIC. If you had a BASIC program in memory when you called the 
monitor, it should still be there. 

M nnnn - MODIFY MEMORY 

This command immediately displays the contents at memory address nnnn. 
You can do one of four things: 

reply with the key and the command proceeds by displaying the 
next position in memory. 

reply with "t” key and the command proceeds to display the pre- 
vious memory position. 

reply with the RETURN key and the command is ended, 
reply with a two-digit hexadecimal number and the RETURN key and 
the command stores this new number in the current memory posi- 
tion. Then you can press Return, or t with the results as above. 

If the M command cannot change the memory location, it will respond with a ”? 


APPENDIX D umiiim^lllllligpi^^ 

ERROR MESSAGES 

The following is a list of error messages. If they occur during a program state- 
ment. the statement number as well as the message is displayed. 

ARITHMETIC OVERFLOW 

The result of a computation is greater than 999999999.9999. This problem can 
be eliminated by using the IF statement to test and limit the sizes of the variables 
in the equation before doing the computation. 

DIMENSION 

Something is wrong in Dimension Statement (size is zero or greater than 99, etc.). 

DIVISION BY ZERO 

The result of dividing by zero is undefined. The computer cannot proceed. This 
problem can be prevent^ by checking the value of a diviser with an IF statement 
before doing the division, 

EXPRESSION 

The expression is not properly formed. Examples are PRINT PEEK 123 - paren- 
thesis not use around expression of a function. PRINT 234-t3) — missing an open 
parenthesis. PRINT 1 *-2 — improper operator symbol in an expression. 

EXPRESSION MISSING 

An expression is expected to be located in a statement but is not found. 

Example: A = (Return Key) 

For H = 
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EXPRESSION TOO LONG 

You did nothing wrong. All computer languages have limits, and you just ran up 
against one of ours, This will occur if an expression has more than 8 nested 
brackets or parenthesis. 

FOR - NEXT 

A NEXT statement was executed when no FOR statement had been executed. 
Check your program. You have forgotten to supply the FOR statement or the 
logic of your program is incorrect. Somehow you branched to a NEXT statement 
without first going through its FOR statement. Fix the logic of your program 
before continuing. 

Example: 10 next I 
RUN 

IF - THEN 

The comparison m the IF statement is wrong. For example, IF A'B THEN 100. 
Fix the statement before running the program. 

ILLEGAL MASK SIZE 

The formal defined for a PRINT USING statement is incorrect. For example, 
there may be more than 9 " » "s to the left of the decimal place, or more than 4 
to the right. Correct the PRINT USING format, called a mask, before running the 
program. 

ILLEGAL VARIABLE 

This is a catchall error message when the mierpretor finds something wrong with 
a variable. Some examples are: 

A variable name starts with an illegal symbol — i.e., a number (1A=3I. You have 
used more than 26 variable names. You used a dimensioned variable name that 
was not dimensioned. 

MEMORY FULL 

You ran out of memory. This will usually occur in a DIM Statement. If so, then 
reduce the allocation in a DIM statement or shorten your program, 

Memory storage is as follows 

1, A numeric variable takes 7 Bytes. A dimensioned numeric array takes 7 
Bytes for each element. Ex - DIM H (365) takes 7* 365 Bytes. 

2. Each line takes 2 Bytes for a line « plus 1 Byte for an end of line symbol. 

3. All keywords (le — PRINT, FOR, etc.) take 1 Byte. 

4, Actual allowable user storage is 7166 Bytes. 

A second reason for Memory Full can be due to your program's continuous 
execution of a FOR statement with no NEXT statement, or continuous execut- 
ing a GOSUB with a RETURN, 

NO - GOSUB 

A RETURN statement was executed without a GOSUB having been executed. 
You have a logic error in your program. Make sure you do not use a GOTO or 
fall into a Subroutine. Fix the problem before running the program. 

NO LINE « - REFERENCED 

You are trying to GOTO a line number which doesn't exist in your program, 
Correct the statement before running your program again. 

PRINT DELIMETER 

There is an error' in your PRINT statement. Check to see that each of the items 
being printed are separated by a comma or semi-colon. Correct the statement 
before running your program. 

QUOTE MISSING 

The right quote in a String Constartt is missing. Correct the statement before 
running the program again. 


READ - DATA 

Either you have executed a READ statement when there is no DATA statement, 
or there is an error in the DATA statement. If there is an error in the DATA 
statement, correct it before running the program again. 

If you are executing a READ statement, then either you forgot to include a 
DATA statement or you have tried to READ more variables than you have data 
in DATA statements. Make sure you have supplied all of the data in the DATA 
statements, or that you haven't executed a READ statement more times than you 
had intended, 

WHAT 

This is a catch-all. It usually means that one of the items in the line should have 
been a keyword but wasn't recognized as such. Carefully check the line and 
correct all errors before running the program again, 

* > 999999999.9999 

You have a constant which has more than four decimal places or which is greater 
than 999999999.9999 or less than -999999999.9999. You will have to change 
your program so that numbers outside of this range are unnecessary. 
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